home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / ManageGeom.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  6.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333))))         TTTTkkkk (((( ))))          TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_ManageGeometry - arrange to handle geometry requests  for
  12.           a window
  13.  
  14.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  16.  
  17.           TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy(_t_k_w_i_n, _p_r_o_c, _c_l_i_e_n_t_D_a_t_a)
  18.  
  19.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  20.           Tk_Window         _t_k_w_i_n        (in)      Token for window to
  21.                                                    be managed.
  22.  
  23.           Tk_GeometryProc   *_p_r_o_c        (in)      Procedure to invoke
  24.                                                    to  handle geometry
  25.                                                    requests on  _t_k_w_i_n,
  26.                                                    or NULL to indicate
  27.                                                    that        _t_k_w_i_n's
  28.                                                    geometry  shouldn't
  29.                                                    be managed anymore.
  30.  
  31.           ClientData        _c_l_i_e_n_t_D_a_t_a   (in)      Arbitrary  one-word
  32.                                                    value  to  pass  to
  33.                                                    _p_r_o_c.
  34.      _________________________________________________________________
  35.  
  36.  
  37.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.           TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy arranges for _p_r_o_c to be  invoked  whenever
  39.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt  is called to change the desired geometry
  40.           for  _t_k_w_i_n.   TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy  is  typically  invoked   by
  41.           geometry  managers  when  they  take  control  of a window's
  42.           geometry.
  43.  
  44.           _P_r_o_c should have arguments and results that match  the  type
  45.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyPPPPrrrroooocccc:
  46.                typedef void Tk_GeometryProc(
  47.                     ClientData _c_l_i_e_n_t_D_a_t_a,
  48.                     Tk_Window _t_k_w_i_n);
  49.           The  parameters  to  _p_r_o_c   will   be   identical   to   the
  50.           corresponding   parameters   passed   to  TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy.
  51.           Typically, _c_l_i_e_n_t_D_a_t_a points to a data structure  containing
  52.           application-specific information about how to manage _t_k_w_i_n's
  53.           geometry.
  54.  
  55.           _P_r_o_c will be called during each call  to  TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt
  56.           for _t_k_w_i_n.  _P_r_o_c can use macros like TTTTkkkk____RRRReeeeqqqqWWWWiiiiddddtttthhhh to retrieve
  57.           the arguments passed to TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt.   It  should  do
  58.           what  it  can  to  meet  the  request,  subject to the space
  59.           available  in  _t_k_w_i_n's  parent  and  its  own  policies  for
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333))))         TTTTkkkk (((( ))))          TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333))))
  71.  
  72.  
  73.  
  74.           managing  geometry.  If _p_r_o_c can meet the request, it should
  75.           call procedures like  TTTTkkkk____RRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww  or  TTTTkkkk____MMMMoooovvvveeeeWWWWiiiinnnnddddoooowwww  to
  76.           carry  out the actual geometry change.  In some cases it may
  77.           make sense for _p_r_o_c not  to  process  the  geometry  request
  78.           immediately,  but  rather  to  schedule a procedure to do it
  79.           later, using TTTTkkkk____DDDDooooWWWWhhhheeeennnnIIIIddddlllleeee.  This approach is likely  to  be
  80.           more efficient in situations where several geometry requests
  81.           occur simultaneously:  only a single geometry change will be
  82.           made, after all the requests have been registered.
  83.  
  84.           If _p_r_o_c is specified as NULL, then the geometry handler  for
  85.           _t_k_w_i_n will be eliminated, leaving _t_k_w_i_n unmanaged.  Calls to
  86.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt have  no  effect  for  unmanaged  windows
  87.           except to store the requested size in a structure where they
  88.           can  be  retrieved   by   macros   like   TTTTkkkk____RRRReeeeqqqqWWWWiiiiddddtttthhhh.    If
  89.           TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt  has never been invoked for a window then
  90.           it is unmanaged.
  91.  
  92.  
  93.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  94.           callback, geometry, managed, request, unmanaged
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/23/95)
  130.  
  131.  
  132.  
  133.